W03-1. 포트 · 볼륨 · 네트워크 - 강의 노트
3주차 강의 노트: 포트 · 볼륨 · 네트워크
- 포트 공개(
-p) 의 원리와127.0.0.1바인딩의 의미를 안다. - 데이터를 컨테이너 밖에 두는 두 방법, 바인드 마운트와 볼륨의 차이를 안다.
- 컨테이너끼리 이름으로 통신하려면 사용자 정의 네트워크가 필요하다는 것을 안다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- 생명주기: Created → Running ⇄ Paused → Exited → 삭제
- 메인 프로세스가 끝나면 컨테이너도 끝난다
- 컨테이너를 지우면 안의 데이터도 사라진다 → 오늘 해결합니다
1. 컨테이너가 가진 세 가지 "벽"
컨테이너는 격리된 프로세스라서 기본적으로 바깥과 막혀 있습니다. 오늘은 그 벽에 필요한 만큼만 구멍을 내는 법을 배웁니다.
| 벽 | 기본 상태 | 오늘 배울 구멍 |
|---|---|---|
| 네트워크 (바깥 ↔ 컨테이너) | 바깥에서 접속 불가 | 포트 공개 -p |
| 저장소 (컨테이너 ↔ 디스크) | 지우면 데이터 사라짐 | 바인드 마운트, 볼륨 -v |
| 컨테이너 ↔ 컨테이너 | 서로 이름을 모름 | 사용자 정의 네트워크 --network |
2. 포트 공개: -p 호스트포트:컨테이너포트
flowchart LR
B["브라우저
localhost:8080"] --> H["내 노트북
8080 번 포트"]
H -- "-p 8080:80" --> C["컨테이너
80 번 포트 (nginx)"]- 컨테이너는 자기만의 네트워크(Namespace)를 가지고 있습니다. 그래서 nginx 가 컨테이너 안에서 80번을 열어도 바깥에서는 안 보입니다.
-p 8080:80은 "노트북의 8080 으로 들어온 요청을 컨테이너의 80 으로 전달해 달라" 는 뜻입니다.
| 쓰는 법 | 의미 | 누가 접속 가능? |
|---|---|---|
-p 8080:80 |
모든 네트워크 카드의 8080 → 80 | 내 노트북 + 같은 네트워크의 다른 PC |
-p 127.0.0.1:8080:80 |
내 노트북 안(localhost)에서만 8080 → 80 | 내 노트북만 |
-P (대문자) |
이미지에 적힌 포트(EXPOSE)를 아무 빈 포트에 연결 | 포트 번호는 docker port 로 확인 |
-p 5432:5432 로 DB 를 띄우면 같은 와이파이의 다른 사람도 접속을 시도할 수 있습니다.
내 노트북에서만 쓸 거라면 -p 127.0.0.1:5432:5432 처럼 막아 둡니다. 실습에서 직접 차이를 확인합니다.
더 좋은 방법은 DB 포트를 아예 공개하지 않고, 같은 네트워크의 컨테이너끼리만 통신하게 하는 것입니다(4장).
EXPOSE 는 "안내문"일 뿐
2주차 docker image history 에서 EXPOSE map[80/tcp:{}] 를 봤습니다. 이것은 "이 이미지는 80번을 씁니다" 라는 문서일 뿐이고, 실제로 열어 주는 것은 -p 입니다.
3. 데이터를 컨테이너 밖에: 바인드 마운트 vs 볼륨
컨테이너 안의 특정 폴더를 컨테이너 밖의 저장 공간과 연결하면, 컨테이너를 지워도 데이터가 남습니다.
flowchart TB
subgraph L["내 노트북"]
F["📁 ~/docker-study/site
(내가 아는 폴더)"]
subgraph VM["Docker 가 관리하는 영역"]
V["🗄️ 볼륨 study-pgdata
(Docker 가 아는 저장소)"]
end
end
C1["nginx 컨테이너
/usr/share/nginx/html"] -- "바인드 마운트" --- F
C2["PostgreSQL 컨테이너
/var/lib/postgresql"] -- "볼륨" --- V| 구분 | 바인드 마운트 (Bind Mount) | 볼륨 (Volume) |
|---|---|---|
| 쓰는 법 | -v /내/폴더/경로:/컨테이너/경로 |
-v 볼륨이름:/컨테이너/경로 |
| 저장 위치 | 내가 지정한 노트북 폴더 | Docker 가 관리하는 영역 |
| 노트북에서 직접 보기·편집 | 쉬움 (VS Code 로 바로 편집) | 어려움 (Docker 를 통해서만) |
| 주 용도 | 개발 중인 소스 코드, 설정 파일 | DB 데이터 등 앱이 쌓는 데이터 |
| 관리 명령 | 없음 (그냥 폴더) | docker volume ls / inspect / rm |
| 비유 | 내 책상 서랍을 빌려줌 | 회사 문서 보관소에 맡김 |
-v 앞부분이 경로(/, C:\, ${PWD} 등으로 시작)면 바인드 마운트, 그냥 이름이면 볼륨입니다.
:ro
-v ...:/usr/share/nginx/html:ro 처럼 끝에 :ro 를 붙이면 컨테이너는 그 폴더를 읽기만 할 수 있습니다. 웹 서버가 해킹당해도 원본 파일은 바꾸지 못하게 하는 안전장치입니다.
볼륨은 앱이 데이터를 쓰는 폴더에 연결해야 의미가 있습니다. 경로는 공식 이미지 설명서(Docker Hub)에 있습니다.
- PostgreSQL 18 이상:
/var/lib/postgresql← 2025년에 바뀐 경로 - PostgreSQL 17 이하:
/var/lib/postgresql/data - MySQL:
/var/lib/mysql
인터넷의 예전 자료를 18 버전에 그대로 쓰면 데이터가 남지 않을 수 있습니다.
4. 컨테이너끼리 통신: 사용자 정의 네트워크
웹 서버 컨테이너가 DB 컨테이너에 접속해야 한다면, 상대를 어떻게 찾을까요?
| 방법 | 문제 |
|---|---|
IP 주소로 (172.17.0.2) |
컨테이너를 다시 만들 때마다 IP 가 바뀝니다 |
이름으로 (study-db) |
기본 네트워크에서는 이름을 못 찾습니다 ❌ 사용자 정의 네트워크에서는 됩니다 ✅ |
flowchart LR
subgraph D["기본 네트워크 (bridge)"]
A1["컨테이너 A"] -. "study-web ? ❌ bad address" .-> A2["study-web"]
end
subgraph N["사용자 정의 네트워크 (study-net)"]
B1["컨테이너 B"] -- "study-web ✅ 이름으로 접속" --> B2["study-web"]
DNS["Docker 내장 DNS"]
enddocker network create study-net으로 네트워크를 만들고, 컨테이너를--network study-net으로 띄웁니다.- 같은 사용자 정의 네트워크에 있는 컨테이너는 Docker 내장 DNS 덕분에 컨테이너 이름이 곧 주소가 됩니다.
- 다른 네트워크의 컨테이너와는 서로 보이지 않습니다. 앱 단위로 네트워크를 나누는 것 자체가 보안 경계입니다.
- Compose 는 앱마다 네트워크를 자동으로 만들어 주고, 서비스 이름으로 통신하게 합니다.
- Kubernetes 의 Service 도 "이름으로 찾아가기" 를 클러스터 전체에서 해 주는 것입니다.
| 드라이버 | 설명 |
|---|---|
bridge |
기본값. 노트북 안에 가상 스위치를 만들어 컨테이너를 연결 |
host |
컨테이너가 호스트의 네트워크를 그대로 사용 (격리 없음) |
none |
네트워크 없음 |
5. 전체 그림: 오늘 실습의 최종 모습
flowchart LR
U["브라우저"] -- "localhost:8080" --> W
subgraph NET["사용자 정의 네트워크 study-net"]
W["study-web (nginx)"]
T["접속 테스트용 컨테이너"] -- "study-db:5432" --> DB["study-db (PostgreSQL)"]
T -- "http://study-web" --> W
end
W --- F["📁 바인드 마운트: site 폴더"]
DB --- V["🗄️ 볼륨: study-pgdata"]- 바깥에 공개하는 것은 웹 서버 포트(8080)뿐입니다.
- DB 는 포트를 공개하지 않고, 같은 네트워크 안에서 이름으로만 접속합니다.
- 데이터는 볼륨에 있어서 DB 컨테이너를 지워도 남습니다.
핵심 요약
3주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 포트 -p 8080:80 노트북 8080 → 컨테이너 80
-p 127.0.0.1:8080:80 내 노트북에서만 접속 가능
EXPOSE 는 안내문, 실제로 여는 건 -p
② 저장 바인드 마운트 -v ${PWD}/site:/경로[:ro] 내 폴더 연결 (코드·설정)
볼륨 -v 이름:/경로 Docker 관리 (DB 데이터)
컨테이너를 지워도 데이터는 남는다
③ 네트워크 기본 bridge: 이름으로 못 찾음
docker network create → 같은 네트워크면 "이름 = 주소"
④ 습관 DB 포트는 공개하지 말고, 같은 네트워크 안에서만 접속
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
- 도커 개요2: 바인드 마운트 · 볼륨 · 포트 공개 상세
- 프록시와 리버스 프록시: 외부에는 프록시만 공개하는 구조
공식 문서:
- 볼륨: https://docs.docker.com/engine/storage/volumes/
- 바인드 마운트: https://docs.docker.com/engine/storage/bind-mounts/
- 브리지 네트워크: https://docs.docker.com/engine/network/drivers/bridge/
- PostgreSQL 공식 이미지(데이터 경로): https://hub.docker.com/_/postgres